home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 November / SGI Freeware 1999 November - Disc 2.iso / dist / fw_IZzip.idb / usr / freeware / src / zip / install.doc.z / install.doc
Text File  |  1997-09-09  |  5KB  |  124 lines
  1. HOW TO INSTALL ZIP
  2.      Zip is distributed as C source code that can be compiled on a
  3.      wide range of Unix machines, VAXes running VMS, and MSDOS
  4.      machines using Microsoft or Borland C++, and OS/2 machines using
  5.      Microsoft C.  You will need Unzip 5.0p1 (under Unix, MSDOS, or VMS)
  6.      or PKUNZIP 2.04g or later (under MSDOS) to unpack the distribution
  7.      file, zip201.zip. But since you read this, you have unpacked it
  8.      already, or you cheated and got a tar.Z file...
  9.  
  10.      Let's assume however that you start from scratch and have not yet
  11.      unpacked the sources. First, unpack the source as follows,
  12.      assuming that you have zip201.zip in the current directory.
  13.  
  14.           mkdir zipsrc
  15.           cd zipsrc
  16.           unzip ../zip201
  17.  
  18.      This extracts all source files and documentation in the
  19.      directory called "zipsrc". If you wish to build a version
  20.      of zip with encryption capabilities, you must also get the
  21.      separate package zcrypt20.zip and uncomment the definition
  22.      of MAKE at the beginning of the makefile.
  23.  
  24.      You then do:
  25.  
  26.           make system
  27.  
  28.      where "system" is one of: generic, 386bsd, 3b1, aix, att6300, aux, bsd,
  29.      bsdold, bull, convex, coherent, cray, cray_v3, dec_osf1, dnix,
  30.      dynix, hpux, isc, linux, minix, next10, next2x, next3x, nextfat, pixel,
  31.      ptx, rs6000, scodos, sco_x286, sgi, sun, sun_gcc, sysv, sysv_gcc,
  32.      sysv_386, sys_386_gcc, sysv_old, ultrix, v7, xenix, xos, zilog.
  33.      Try "make generic" first, this works on most systems. If this
  34.      fails, then use one of the special targets given above.
  35.  
  36.      If you are using a NeXT, then make next for help about various
  37.      NeXT targets.  Among other special systems are HPUX, DNIX 5.2 or
  38.      5.3, Cray Unicos, AT&T 3B1 (also known as Unix PC or PC 7300),
  39.      Zilog Zeus, A/UX, Convex, AIX, MINIX, ISC System V/386, Dynix,
  40.      Ultrix and DEC OSF/1.
  41.  
  42.      If you are using BSD Unix, try bsd.  If the linker cannot find
  43.      _memset or _memcpy, try bsdold or v7.  If you are using System V
  44.      Unix or SCO Unix, try sysv or sysv_old.  Also use sysv on a
  45.      Silicon Graphics (SGI) machine.  You can also cross-compile Zip
  46.      for MSDOS under SCO 386 Unix using "make scodos". If you get
  47.      error messages "constant expected" in deflate.c, add -DDYN_ALLOC
  48.      to CFLAGS in your makefile entry.
  49.  
  50.      If you have lots of memory, try compiling with -DBIG_MEM. If your
  51.      system supports mmap(), try compiling with -DMMAP. This generally
  52.      gives faster compression but uses more memory. See the Makefile
  53.      entry mmap_gcc for an example.
  54.  
  55.      If none of these compiles, links, and functions properly on
  56.      your Unix system, see the file README for how to get help.
  57.  
  58.      If the appropriate system was selected, then the executables
  59.      zip, zipnote and zipsplit will be created.  You can copy them
  60.      to an appropriate directory in the search path using:
  61.  
  62.           make install
  63.  
  64.      The defaults are /usr/local/bin for the executables and
  65.      /usr/man/man1 for the manual page. Change the macros BINDIR
  66.      and MANDIR in makefile if appropriate.
  67.  
  68.      You can use the command "set" to see the current search
  69.      path.  If you are using the C-Shell (csh), enter the com-
  70.      mand:
  71.  
  72.           rehash
  73.  
  74.      so csh can find the new command in the path.  You are now
  75.      ready to use Zip.
  76.  
  77.      You can get rid of the now unnecessary source and object
  78.      files with:
  79.  
  80.           cd ..
  81.           rm -r zipsrc
  82.  
  83.      This will remove the directory zip and its contents created
  84.      by unzip.  You should keep the zip20.zip file around though,
  85.      in case you need to build it again or want to give it to a
  86.      colleague.
  87.  
  88.      You can add the following lines to the file /etc/magic for
  89.      usage by the 'file' command:
  90.  
  91. 0    string        PK\003\004    Zip archive
  92. >4    string        \011        (at least v0.9 to extract)
  93. >4    string        \012        (at least v1.0 to extract)
  94. >4    string        \013        (at least v1.1 to extract)
  95. >4    string        \024        (at least v2.0 to extract)
  96.  
  97.  
  98.      The steps for installation under MSDOS, OS/2, and VMS are
  99.      similar to the above: first unzip the distribution files
  100.      into their own directory. The system dependant files are
  101.      stored in special subdirectories. You may have to
  102.      copy or move them to the main sources directory.
  103.      Then under MSDOS do one of:
  104.  
  105.           make makefile.msc
  106.           make -fmakefile.bor
  107.  
  108.      for Microsoft or Borland C++, respectively. For Turbo C 2.0,
  109.      use the configuration file tcconfig.tc, the batch file
  110.      doturboc.bat and the project files zip.prj, zipnote.prj
  111.      and zipsplit.prj. Make sure to use the compact model.
  112.  
  113.      Under OS/2:
  114.  
  115.           nmake -f makefile.os2
  116.  
  117.      for Microsoft C 6.00.  Under VAX VMS:
  118.  
  119.           @make_vaxc
  120.      or:  @make_gcc
  121.  
  122.      For command help on any of the zip* utilities, simply enter
  123.      the name with no arguments.
  124.